开发指南

一、点位上图

1.1 点位上图管理

高德企业智图提供两种方式来存储点位数据： ●企业智图管理平台：通过可视化操作界面完成创建表、导入数据、编辑数据、删除数据、表的字段创建、删除等。 ●企业智图点位上图API：通过https形式的API接口服务，完成数据存储、实时更新、删除（批量删除）等操作。 开发者首先登录企业智图管理平台https://me.amap.com进入存储空间，可体验：

1.1.1 登录高德企业智图

在开始使用之前，您需要注册一个高德账号。高德账号在高德体系下是通用的。 登录网址：https://me.amap.com，右下角有注册入口。

1.1.2 添加点位图层

首先，添加一个点位图层，设置图层名称，如北京市网点，回车保存。 每个企业客户最多支持20个图层。

1.1.3 查询图层id

在API接口中，需要传入图层id即layerId，获取方式如下图，点击点位/区块图层更多，打开图层信息，即可获取到layerId。

1.1.4 批量上传点数据

上传点位的文件格式为CSV（UTF-8）。  

1）下载模板

图层创建好之后，点击 上传点数据 按钮，系统提示下载模板，按照模板格式上传点数据，可以选择以下两种模板： ○地址模板：名称、地址为必填项，其他为选填项，支持添加自定义字段； ○经纬度模板：名称、经度、纬度为必填项，其他为选填项，支持添加自定义字段； 将您自己的数据，改成模板要求的列名，其中，自定义字段可以自由设置，默认支持30个自定义字段。

2） 上传预览

上传预览时，可以选择字段类型，支持3种选择：文本型、整数型、小数型。 确认好字段类型后，点击右下角的“数据上图”，开始上传数据。

3） 上传成功

上传完成后，可以查看到上传的数据列表，以及地图上的散点效果。 点击左侧某条数据，地图上会对应找到相应的点位，并且右侧拉出点位详情，如下图。 点位详情中，展示您的所有数据内容，包括自定义字段及值。

1.1.5 手动标点

点击手动标点，可以在地图上创建一个新的点，系统通过该点所在经纬度，自动解析地址（rgeo）。

1.1.6 点位上图API

开发者通过HTTP形式接口对某个图层表进行数据存储、更新、删除等操作，返回格式为json。具体可操作如下： ●新增点数据（单条、批量） 支持单条新增和批量新增。 单条新增：通过上传坐标（高德坐标/GCJ02坐标）或地址（完整的省、市、区、地址信息）进行定位，企业智图将根据上传数据的坐标或地址计算出在高德地图上准确显示的坐标。 批量新增：通过上传csv文件实现（对于中文仅支持UTF8编码），一次上传100条以内的数据，支持30个任意字段命名。 ●更新点数据 根据数据唯一标识_id，对已有点数据进行更新修改，一次最多更新100条数据。 ●删除点数据 根据数据唯一标识_id，一次最多删除100条数据。 ●查询点数据 根据layerId，查询所有点数据（可指定前**条），支持获取指定字段。

1.2 点位搜索/空间检索

高德企业智图提供了对点位数据的搜索服务，目前提供了 web API、JS API和Android/IOS SDK 四套接口。支持的检索方式有：关键词搜索、ID搜索、多边形检索、周边检索。

1.2.1 关键词搜索

在某图层表中，指定城市（全国/省/市/区县）范围，搜索符合查询条件的数据，并按照给定排序规则返回结果。其中全国等同于对该数据表全表数据进行检索，支持设置筛选条件，并按给定排序规则返回结果。  

1.2.2 id搜索

在某图层表中，根据数据id查询一条数据。

1.2.3 周边检索

在某图层表中，给定中心点和半径范围，搜索符合查询条件的数据，并按给定排序规则返回结果。  

1.2.4 多边形检索

在某图层表中，在给定的多边形（矩形和任意多边形）范围内，搜索符合查询条件的数据，并按给定排序规则返回结果。 接口参考文档如下： ●Web API：详见参考文档 ●企业智图Android SDK：https://a.amap.com/lbs/static/unzip/Android_Map_Doc/index.html ●企业智图IOS SDK：https://a.amap.com/lbs/static/unzip/iOS_Map_Doc/AMap_iOS_API_Doc_Search/annotated.html

1.3 API参数详解

对于企业智图的点位上图和点位搜索/空间搜索中，layerId，keywords，filter，sortrule参数详细说明如下。

1.3.1 图层的标识码（layerId）

您所创建的每个图层的唯一标识符，由24位的字母和数字组成的字符串。 您使用企业智图API或SDK开发时，该项为必填参数，用以识别您需要对创建的哪一个图层进行存储和检索操作。 layerId的获取方法：调用API接口“查询点数据”- 返回结果参数（包含layerId）

1.3.2 配置文本索引（keywords）

企业智图云检索API的keywords参数是进行有效搜索的必须条件。 1）企业智图云检索API中keywords参数： 仅对建立【文本索引】的字段列内容，进行关键词（keywords）的搜索； 默认无文本索引，需要您自行添加文本索引，实时生效。 2）添加文本索引： 需在企业智图管理平台完成设置，仅支持对文本型字段添加文本索引。 3）添加文本索引步骤： 第一步： 登录企业智图管理平台； 第二步： 打开您所创建的图层； 第三步： 如下图，配置文本索引，添加字段（文本型）。

1.3.3 配置筛选排序索引（filter, sortrule）

企业智图云检索API中的筛选filter和排序sortrule参数是进行有效过滤的必须条件。 1）企业智图云检索API中的filter，sortrule参数： 仅对建立【筛选排序索引】的字段列内容，进行filter过滤以及sortrule排序； 默认无文本索引，需要您自行添加筛选排序索引，实时生效。 b. 添加筛选排序索引： 需在企业智图管理平台完成设置，仅支持对文本型字段添加文本索引； 支持对任意类型的字段列添加筛选排序索引。 c. 添加筛选排序索引步骤： 第一步： 登录企业智图管理平台； 第二步： 打开您所创建的图层； 第三步： 配置筛选排序索引，添加字段（文本型、整数型、小数型）。

二、区块上图

2.1 区块上图

我们将区块上图中的区块划分为三种类型：通用区块、特色区块、高级区块。 ●通用区块，指自定义区块 ●特色区块，指高德特色区块数据资源，包括行政区划、缓冲区、AOI、商圈、自然街区等； ●高级区块，可支持统一的字段结构，支持区块的合并拆分；

2.1.1 通用区块上图

应用场景示例：支持用户绘制自定义区块，支持多图层叠加显示分析。 使用步骤：添加区块图层-添加数据-设置区块样式-区块删改。

1、添加区块图层

●首先，添加区块图层，选择区块类型。 ●选择自定义区块，设置图层名称，如北京配送范围，回车保存。

2、添加数据

添加数据，目前支持两种形式：手动绘制区块、批量添加区块。 2.1 手动绘制区块 ●选择添加面数据，平台跳转进入自定义区块图层内部。 ●点击地图右上角的 多边形，开启地图绘制多边形功能。 ●在地图上点击左键，绘制第一个点，将鼠标移动到其他位置，继续点击左键绘制第二个点，依此类推，绘制第三、四、五个点，最后双击左键，完成区块绘制。 ●需要说明的是，至少需要绘制三个点，来完成区块的绘制。 ●双击保存区块，默认区块名称为 区块1、2、3… 2.2 批量上传数据 ●在自定义图层中，还可以批量上传区块数据。 ●点击 上传wkt，下载数据模板，按模板格式提供区块名称和区块围栏WKT。 ●预览并确认上传的数据，点击数据上图，完成上传。

3、设置区块样式

●在自定义区块图层，选择图层样式，可以设置区块图层的整体样式，支持区块填充颜色、透明度、区块边框颜色、透明度、边框粗细，及区块标签。

4、区块删改

●编辑区块节点 ○首先，选中要编辑的区块，点击右侧详情中的 编辑节点 按钮； ○该区块的节点高亮显示，这时可以手动拖拽每个节点，来修改区块的边界范围。 ○同时，在编辑时，可以在已有边上，点击增加新的节点，方便更灵活地调整区块范围。 ○双击某个节点，可以删除该节点。 ○修改完成后，点击保存完成区块的编辑。 ●删除区块 ○在区块详情弹窗中，提供删除区块功能，允许删除单个区块及其属性数据。

2.1.2 特色区块上图

应用场景示例：将标准行政区划（省、市、区/县、乡镇/街道、村/居委会）、企业的网点辐射范围（缓冲区）、客户所在的小区AOI、商圈、自然街区等快速上图，支持多图层叠加显示分析。 使用步骤：添加区块图层-添加数据-区块删除。

1、添加区块图层

●首先，添加区块图层，选择区块类型。 ●选择行政区划，设置图层名称，如北京市朝阳区，回车保存。 ●选择缓冲区，设置图层名称，如网点辐射范围，回车保存。 ●选择AOI，设置图层名称，如望京小区，回车保存。

2、添加数据

添加数据，目前支持三种形式：添加行政区划、生成缓冲区、添加AOI； 后续会增加商圈、自然街区、智能分区等形式； 2.1 添加行政区划 ●选择添加行政区划数据，平台弹出“导入行政区划”弹框，如下图。 ●点击复选框，可以选择多个行政区划边界数据。注意单次导入不超过100个区块。 ●省界、市界、区县界、乡镇界、村区块，这几个级别的区块数据可以叠加上传，支持叠加显示。 ●注：本村/社区区块数据仅做参考，并非法定的村/社区行政区划边界。 ●确定上传后，平台自动将您选择的行政区划围栏导入到图层内，如下图： 注意：行政区划图层内的数据，是只读的，只能用于展示、空间检索、空间计算（村暂不支持）等，不可编辑。 2.2 生成缓冲区 ●选择添加面数据，平台跳转进入缓冲区图层内部。 ●选择点位图层，为北京银行网点； ●设置缓冲距离，为1km； ●点击生成缓冲区按钮，平台将以网点为中心，1km为半径，自动生成全部缓冲区，如下图所示。 2.3 添加AOI ●选择添加AOI数据，平台弹出“导入AOI”弹框，目前仅支持住宅区和写字楼两种类型，如下图。 ●点击单选框，每次仅可以选择一种类型的AOI数据。注意单次导入不超过1000个AOI。 ●确定上传后，平台自动将您选择的AOI围栏导入到图层内，如下图： 注意：AOI图层内的数据，是只读的，只能用于展示、空间检索等，不可编辑。

2.1.3 高级区块上图

1、添加高级区块图层

需要在右上角头像-下拉菜单-图层管理中，点击添加图层。 输入图层名称后，确认保存。可以添加多个图层，这些图层将拥有相同的字段。 高级区块图层也可自定义字段，字段类型支持整数型、小数型和文本型。

2、批量上传数据

² 在高级区块图层中，支持批量上传区块数据。 ●点击 上传wkt，下载数据模板，按模板格式提供区块名称和区块围栏WKT；高级区块模板中，支持自定义字段（以后台设置的字段为准）。 ●预览并确认上传的数据，点击数据上图，完成上传。

3、设置区块样式

●在高级区块图层内，选择图层样式，可以设置区块图层的整体样式，支持区块填充颜色、透明度、区块边框颜色、透明度、边框粗细，及区块标签。

4、区块删改

●编辑区块节点 ○首先，选中要编辑的区块，点击右侧详情中的 编辑节点 按钮； ○该区块的节点高亮显示，这时可以手动拖拽每个节点，来修改区块的边界范围。 ○同时，在编辑时，可以在已有边上，点击增加新的节点，方便更灵活地调整区块范围。 ○双击某个节点，可以删除该节点。 ○修改完成后，点击保存完成区块的编辑。 ●删除区块 ○在区块详情弹窗中，提供删除区块功能，允许删除单个区块及其属性数据。

5、区块的合并、拆分

●对于高级区块图层，还可进行拆分、合并；其中，拆分支持线拆分、面拆分。

2.1.4 区块查点

选择任意区块，点击右上角的“区块查点”功能。 系统提示：跳转页面查看结果，如下图： 确认后，系统跳转到 空间检索 页面，并且返回检索到的点位结果； 用户可以点击左侧的结果图层，来逐条查看结果点位，也可以将整个图层分别保存为一个新的图层。

2.2 点查区块接口调用

给定某点的经纬度坐标或者标准地址，提供查询该点所属的所有自定义区块结果。 具体参见“参考文档”3.5点查区块接口。